package com.agan.limit.aop;

import java.lang.annotation.*;
import java.util.concurrent.TimeUnit;

/**
 * 自定义限流注解
 *
 * @author weicj
 * @since 2025.01.24
 */
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
@Documented
public @interface Limit {

    /**
     * 资源的key,唯一
     * 作用：不同的接口，不同的流量控制
     */
    String key() default "";

    /**
     * 1秒内最多的访问限制次数
     */
    double limitNum();

    /**
     * 获取令牌最大等待时间 1秒内未获取令牌就降级
     */
    long timeout() default 1;

    /**
     * 令牌过期时间
     */
    long expire() default 1;

    /**
     * 获取令牌最大等待时间,单位(例:分钟/秒/毫秒) 默认:秒
     */
    TimeUnit timeunit() default TimeUnit.SECONDS;

    /**
     * 得不到令牌的提示语
     */
    String msg() default "系统繁忙,请稍后再试.";

}
